package com.example.sqbmservice.Core.config;




import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class OpenApiConfig {
    @Bean //创建由spring容器管理的bean对象
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                // 文档基本信息
                .info(new Info()
                        .title("社区服务管理系统 API 文档") // 标题
                        .description("这是一个集成示例，包含用户管理、订单接口等") // 描述
                        .version("v1.0.0") // 版本
                        // 联系人信息
                        .contact(new Contact()
                                .name("开发团队")
                                .email("dev@qyc.com")
                                .url("https://qyc.com"))
                        // 许可证信息
                        .license(new License()
                                .name("Apache 2.0")
                                .url("https://www.apache.org/licenses/LICENSE-2.0"))
                        // 概述信息
                        .summary("SpringBoot3集成Knife4j示例文档")
                        .termsOfService("https://www.wksttudy.cn")
                        // 配置版本号
                        .version("1.0")
                )
                 //定义 JWT 认证方案， 配置后，Swagger UI 会显示“Authorize” 按钮，可输入Token进行认证。
                .components(new Components()
                .addSecuritySchemes("bearerAuth", new SecurityScheme()
                        .type(SecurityScheme.Type.HTTP)
                        .scheme("bearer")
                        .bearerFormat("JWT")))
                // 全局启用认证（所有接口默认需要 Token）
                .addSecurityItem(new SecurityRequirement().addList("bearerAuth"));


    }
}
